home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / tagger35.arc / TAGGER.DOC < prev    next >
Text File  |  1990-03-01  |  13KB  |  354 lines

  1.                       TAGGER  (C)  E.J.BLAYER 1989
  2.  
  3.  Version 3.5 8/23/89
  4.  Fixup for QMODEM'S TSR Trap added, Output filenames wouldn't work.
  5.  
  6.  Version 3.4 7/31/89
  7.  Added EGA 43 line and VGA 50 line support ..........
  8.  
  9.  Please DISTRIBUTE this Package INTACT . NO ALTERATIONS AUTHORIZED
  10.  
  11.  NO WARRANTY EXPRESSED OR IMPLIED.
  12.  
  13.  This software has been tested in a number of xt,at machines
  14.  and thought to be bug free. Hardware should be 100% IBM (tm) compatible.
  15.  User Assumes the responsibility for its actions or lack thereof.
  16.  
  17.  END OF MUMBO-JUMBO.
  18.  
  19.  USING TAGGER -Jump start (SEE Mouse Support also)
  20.     A Utility To AID in Selection of Files ON or OFF Line With
  21.     Your Current MODEM Program to PCBOARD (tm) SYSTEMS....
  22.  
  23.     Purpose is to "TAG", or capture, file names on a pcboard (tm) bbs ,
  24.     and output them at at the Zdoor or Prodoor all at once ....
  25.     Tagged file names can also be output selectively one at a time
  26.     if you are not using a batch type receive protocol.
  27.  
  28.     Off Line Selection Can be done with getfiles.bat  . Change to
  29.     suit your current arc,zip,??? utility ,file lister ,and modem
  30.     program.
  31.  
  32.     Basic Use:
  33.     The Modem Pgm is Run as a Child Process ...
  34.     Examples of Command lines for various modem programs:
  35.  
  36.     C:> TAGGER PROCOMM ["options"]
  37.  
  38.     C:> tagger c:\zcomm\zcomm "call stockton"
  39.  
  40.     C:> TAGGER BOYAN
  41.  
  42.     Options must be in quotes....
  43.  
  44.     At this point you would log into your bbs as usual using whatever
  45.     normal faculties of the modem program.
  46.  
  47.     After log in , list files available with normal PCBOARD(tm) commands.
  48.     Examples :
  49.  
  50.     (29 Minutes Left) Main Board Command : N S 20
  51.  
  52.     (28 Minutes Left) Main Board Command : f 30
  53.  
  54.     (27 Minutes Left) Main Board Command : f 1
  55.  
  56.     When You Have a screen full of file names ,HIT ALT-Z
  57.     NOTE: This Hot Key can be user defined if the alt-z combination
  58.       is used by the modem program.
  59.  
  60.     Tagger will then be activated...
  61.     A status line will appear at the bottom of the screen and
  62.     the TOP line will appear reverse video.
  63.  
  64.     Use the arrow keys to move up and down the screen ....
  65.     The keys on the keypad are used to tag file names (+)
  66.  
  67.     Tag a few file names by moving to a line with the arrow keys,
  68.     and then hitting the "+" key. Each time you "TAG" a filename
  69.     a TAG count on the STATUS line will increment
  70.     Up to 20 files can be TAGGED .. Which is the limit of
  71.     number of files you can download in on call from most PCBOARD (tm)
  72.     systems.
  73.  
  74.     At this point you can edit your TAG list by hitting the "e" key.
  75.  
  76.     A window will appear showing the files names you have TAGGED.
  77.     The arrow keys can be used to walk up and down the window.
  78.     If the "d" key is hit the presently highlighted name will be
  79.     deleted from the list.
  80.  
  81.     You exit the EDIT function with ESC.
  82.  
  83.     TAgger is still active and you have TAGGED all you need at this
  84.     point on this "page" of file names.
  85.     Hit the ESC or END key to leave TAGGER.
  86.  
  87.     you are now out of "TAGGER" and back in your modem program.
  88.     Hit return to list more files (if more are available)
  89.  
  90.     Hit alt-Z (HOT KEY) to call up TAGGER and tag more files ....
  91.     END or ESC key to stop......
  92.  
  93.     After selecting (TAGGING) all needed files ..
  94.  
  95.     OPen the PCBOARD's Door 1 and at the prompt enter  D  and ENTER
  96.     The door will then ask for file names .
  97.     To output your TAGGED file names ,
  98.     activate TAGGER with the HOT KEY (default is ALT-Z)
  99.     Then hit the minus key .....
  100.  
  101.     All the file names that were TAGGED will be then be output at the
  102.     DOOR prompt for file names.
  103.     TAGGER has switched off into the background.
  104.     If you now hit the enter key the PCBOARD(tm) will commence download
  105.     of your requested files.
  106.  
  107.     COMMAND SUMMARY WHEN TAG is ACTIVE
  108.  
  109.             + = tag this file
  110.             - = output all file names
  111.             * = clear all file names
  112.  
  113.             E = edit TAGGED list
  114.                  D=delete current item in TAG list
  115.                  ESC= end edit
  116.  
  117.             / = Send Selected single filename from TAG list
  118.                  use up dwn arrows to move to filename.
  119.                  - = send current single filename.
  120.  
  121.             UP and DOWN arrows to move around
  122.  
  123.             END or ESC to deactivate Tag ,and return to modem pgm
  124.  
  125.  
  126.     SETUP - REQUIREMENTS
  127.         100 % true blue or CLONE ,,and About 60k of memory more
  128.         than your Modem program uses.
  129.         Copy TAGGER.EXE to your working path directory.
  130.  
  131.  
  132.     SETTING THE HOT KEY with environment variable TAGKEY..
  133.     In your autoexec.bat ,add a TAGKEY setting to use other than the
  134.     default HOT KEY alt-z.
  135.     EXAMPLE:
  136.  
  137.         set TAGKEY=081c
  138.  
  139.     Makes the ALT-enter key on the keypad the hot key...
  140.              1c is the scan code for that key
  141.              08 is the additional ALT key
  142.  
  143.   -------------------------------------------------------------------------
  144.  
  145.     To determine the key desired, form 4 hex digits from the following:
  146.  
  147.     The First two Digits from this table;
  148.           8 4 2 1    8 4 2 1
  149.           1 . . .    . . . .      Insert locked
  150.           . 1 . .    . . . .      Caps Lock locked
  151.           . . 1 .    . . . .      Num Lock locked
  152.           . . . 1    . . . .      Scroll Lock locked
  153.           . . . .    1 . . .      Alt key is pressed
  154.           . . . .    . 1 . .      Ctrl key is pressed
  155.           . . . .    . . 1 .      Left Shift key is pressed
  156.           . . . .    . . . 1      Right Shift key is pressed
  157.  
  158.      therefore:   0        8          is for alt
  159.  
  160.    Other 2 digits (scan code) are taken from this list:
  161.  
  162.                       TYPE OF KEYBOARD
  163.                    ----------------------------------------
  164.      Keystroke               83/84-Key     101/102-Key    101/102-Key
  165.                    Standard      Standard        Extended
  166.  
  167.      Esc            01         same        same
  168.      1                02         same        same
  169.      2                03         same        same
  170.      3                04         same        same
  171.      4                05         same        same
  172.      5                06         same        same
  173.      6                07         same        same
  174.      7                08         same        same
  175.      8                09         same        same
  176.      9                0A         same        same
  177.      0                0B         same        same
  178.      -                0C         same        same
  179.      =                0D         same        same
  180.      Backspace            0E         same        same
  181.      Tab            0F         same        same
  182.      q                10         same        same
  183.      w                11         same        same
  184.      e                12         same        same
  185.      r                13         same        same
  186.      t                14         same        same
  187.      y                15         same        same
  188.      u                16         same        same
  189.      i                17         same        same
  190.      o                18         same        same
  191.      p                19         same        same
  192.      [                1A         same        same
  193.      ]                1B         same        same
  194.      Enter            1C         same        same
  195.      Ctrl            **         **         **
  196.      a                1E         same        same
  197.      s                1F         same        same
  198.      d                20         same        same
  199.      f                21         same        same
  200.      g                22         same        same
  201.      h                23         same        same
  202.      j                24         same        same
  203.      k                25         same        same
  204.      l                26         same        same
  205.      ;                27         same        same
  206.      ;                27         same        same
  207.      '              28         same        same
  208.      `                29         same        same
  209.      Shift            **         **         **
  210.      \                2B         same        same
  211.      z                2C         same        same
  212.      x                2D         same        same
  213.      c                2E         same        same
  214.      v                2F         same        same
  215.      b                30         same        same
  216.      n                31         same        same
  217.      m                32         same        same
  218.      ,                33         same        same
  219.      .                34         same        same
  220.      /                35         same        same
  221.      Gray *            37         same        same
  222.      Alt            **         **         **
  223.      Space            39         same        same
  224.      Caps Lock            **         **         **
  225.      F1             3B         same        same
  226.      F2             3C         same        same
  227.      F2             3C         same        same
  228.      F3             3D         same        same
  229.      F4             3E         same        same
  230.      F5             3F         same        same
  231.      F6             40         same        same
  232.      F7             41         same        same
  233.      F8             42         same        same
  234.      F9             43         same        same
  235.      F10            44         same        same
  236.      F11            no key         --         85
  237.      F12            no key         --         86
  238.      Num Lock            **         **         **
  239.      Scroll Lock        **         **         **
  240.      White Home         47         same        same
  241.      White Up Arrow        48         same        same
  242.      White PgUp         49         same        same
  243.      Gray -            4A         same        same
  244.      White Left Arrow        4B         same        same
  245.      Center Key         --         --         4C
  246.      White Right Arrow        4D         same        same
  247.      Gray +            4E         same        same
  248.      Gray +            4E         same        same
  249.      White End            4F         same        same
  250.      White Down Arrow        50         same        same
  251.      White PgDn         51         same        same
  252.      White Ins            52         same        same
  253.      White Del            53         same        same
  254.      SysReq            no key         **         **
  255.      Key 45 [5]         no key         56         same
  256.      Enter (number keypad)    no key         1C         E0
  257.      Gray /            no key         35         E0
  258.      PrtSc            no key         **         **
  259.      Pause            no key         **         **
  260.      Gray Home            no key         47         47
  261.      Gray Up Arrow        no key         48         48
  262.      Gray Page Up        no key         49         49
  263.      Gray Left Arrow        no key         4B         4B
  264.      Gray Right Arrow        no key         4D         4D
  265.      Gray End            no key         4F         4F
  266.      Gray Down Arrow        no key         50         50
  267.      Gray Page Down        no key         51         51
  268.      Gray Insert        no key         52         52
  269.      Gray Insert        no key         52         52
  270.      Gray Delete        no key         53         53
  271.                       
  272. --------------------------------------------------------------------------
  273.     FILE SELECTION OFF LINE
  274.  
  275.     Using GETFILES.BAT
  276.     This Utility Shows HOW to automate the process of:
  277.  
  278.      1. Un-archiving the master list such as COMPUDAT.ARC or SSCFILES.ARC.
  279.  
  280.      2. Using a listing program to page through the file lists,
  281.         from which you would use TAGGER to collect file names,
  282.  
  283.      3. Run your modem program and use tagger to send the collected
  284.         file names to the bbs for download.
  285.  
  286.  
  287.        The first time user may wish to use the following:
  288.         c:>TAGGER COMMAND
  289.  
  290.     This will Envoke a new command.com from a shell under TAGGER.
  291.     You can now list the bbs's master file in any way you wish.
  292.     Activate TAGGER at any time with the hot key and TAG file names.
  293.  
  294.     Exit the listing program and run your modem program as usual.
  295.     Tagger is holding your file list .
  296.     Activate Tagger at the door prompt as described in the on line
  297.     procedure and output the file names.
  298.     When you exit the modem program ,at the dos prompt type EXIT
  299.     and hit enter..
  300.     This will dissolve TAGGER and remove it from memory...
  301.  
  302.     MOUSE SUPPORT
  303.     Release 3.0 an up Has mouse support , If You have a mouse driver
  304.     that does not support the "SAVE MOUSE STATE" function ,the
  305.     mouse CANNOT be used ...Try to get an updated mouse driver.
  306.  
  307.     The Functions are used as follows:
  308.         1. With TAGGER activated with the HOT-KEY,click
  309.            the LEFT button on a line with a filename to
  310.            add to the TAG list.
  311.  
  312.         2. Click the LEFT button on any Status line function
  313.            to activate that function.
  314.  
  315.         3. Click the RIGHT mouse button to EXIT the current
  316.            Function ,even tagger itself..
  317.  
  318.         4. An additional Point and Drag FILENAME pickup is
  319.            available only with the mouse.
  320.            It is available by clicking Left button at the
  321.            far left of the STATUS line. Notification that
  322.            this function is active is a Flashing "*" in the
  323.            TAG name on the status line. You can now pickup
  324.            a single filename by placing the mouse cursor on
  325.            the item to be picked up and press the left button,
  326.            hold and drag left or right ,when button is released
  327.            pickup ends..
  328.            This will be most useful in picking file names up in
  329.            messages and on non PCBOARD(tm) systems where several
  330.            columns of file names exist.
  331.            This function is a one shot,your back to the standard
  332.            pickup.Activate it again to point and drag...
  333.            RIGHT button will cancel this mode if you decide not
  334.            to pickup a text block.
  335.            If the area selected is longer than a permissible
  336.            filename length (xxxxxxxx.xxx) the excess is clipped off.
  337.  
  338.     PROBLEMS -MACHINE LOCKUPS...ECT...
  339.         This  program acts as a TSR in affect and could conflict
  340.         with other ill behaved TSR programs. Unload ALL other TSR's
  341.         and try them one at a time to locate the culprit...
  342.  
  343.     MODEM PROGRAMS
  344.     Tested with ZCOMM,PROCOMM,TELIX,BOYAN.
  345.     MEMORY .. TAGGER uses approximatly 36K.
  346.  
  347.  
  348.     Need Feedback on any problems .....
  349.     LEAVE msg on Stockton PCBOARD 609-652-4914
  350.  
  351.     ED BLAYER
  352.     1008 W.BAY Ave
  353.     Barnegat,NJ 08005
  354.